home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / gfx / misc / JPEG_Comment.lha / JPEG_+_Comment.doc < prev    next >
Text File  |  1996-09-01  |  8KB  |  200 lines
  1. JPEG_+_Comment 1.10
  2. © 1995 Felix Coronado
  3. ------------------------
  4. ARexx Pseudo-Loader for JPEG files & JPEG file comments
  5. For use with The Art Department Professional v2.5
  6.  
  7.                          ------------------------
  8.  
  9.  Copyright and Distribution
  10.  ==========================
  11.  JPEG_+_Comment is copyright 1995 by Felix Coronado.  All rights reserved.
  12.  
  13.  
  14.  JPEG_+_Comment is Freeware and it may be distributed only if:
  15.  
  16.  1. it is in its original unmodified form
  17.  2. it is accompanied by this documentation
  18.  3. nothing is charged for it, other than the cost of the media and nominal
  19.     duplication fees
  20.  
  21.  Any distribution of JPEG_+_Comment that does not meet all of the above
  22.  requirements must have the prior written permission of the author (Felix C.
  23.  Coronado).
  24.  
  25.  Permission is granted to include JPEG_+_Comment in Fred Fish's Amiga Disk
  26.  Library (including CD ROM versions of it) and the AmiNet CD ROMs.
  27.  
  28.                          ------------------------
  29.  
  30.  Disclaimer
  31.  ==========
  32.  This program (JPEG_+_Comment) comes with no warranty, either expressed or
  33.  implied.  The author (Felix Coronado) is in no way responsible for any
  34.  damage, loss, or ill-effects directly or indirectly caused by the usage of
  35.  this program.
  36.  
  37.                          ------------------------
  38.  
  39.  What Does It Do?
  40.  ===============
  41.  JPEG_+_Comment is an ARexx script for use with ADPro 2.5 that searches for
  42.  and displays any text comments contained in a JPEG file, then loads the file
  43.  into ADPro's image buffer.
  44.  
  45.  NOTE: JPEG_+_Comment will only search for comments in JFIF JPEG files, as
  46.  this is the only type of JPEG file that it was designed to recognize.  This
  47.  limitation is due to the fact that I have no information on the other
  48.  varieties (HSI JPEGs, TIFF JPEGs, PICT JPEGs, & others?) of JPEGs.  It
  49.  wouldn't make much sense to add support for any of those types but HSI,
  50.  since the ADPro JPEG Loader only supports JFIF and HSI JPEGS.
  51.  
  52.                          ------------------------
  53.  
  54.  Requirements
  55.  ============
  56.  1. ARexx
  57.  2. Art Department Professional version 2.5
  58.  3. ADPro JPEG Loader
  59.  
  60.                          ------------------------
  61.  
  62.  Installation
  63.  ============
  64.  Copy JPEG_+_Comment to your ADPro:Loaders2 directory or elsewhere.
  65.  
  66.                          ------------------------
  67.  
  68.  Using it
  69.  ========
  70.  Start JPEG_+_Comment using the instructions for launching ARexx scripts in
  71.  your ADPro manual, or any other method you can think of.
  72.  
  73.  Once it starts, you will see a requester with the words "Smoothing Off" and
  74.  three buttons.  The right button (Cancel) aborts the script.  The middle
  75.  button changes the Smoothing status of the JPEG Loader as shown in the
  76.  requester.  The left button (OK) accepts the Smoothing status and displays a
  77.  file requester from which to pick a JPEG file to load.
  78.  
  79.  If the file you pick is a JPEG file, a small window will open showing the
  80.  following:
  81.  
  82.      File: <the JPEG file you selected>
  83.      Smoothing: <the Smoothing status of the JPEG Loader>
  84.  
  85.      Searching for comments...
  86.  
  87.      Ctrl-d to stop
  88.  
  89.  JPEG_+_Comment is now searching the selected file for comments.  If you
  90.  press Ctrl-d (the "Ctrl" key and the "d" key at the same time) while this
  91.  window is open, JPEG_+_Comment will stop searching for comments and go on to
  92.  the rest of the script.  Pressing Ctrl-c while this window is open will
  93.  abort the script.
  94.  
  95.  If you stop the search before any comments are found, or if no comments are
  96.  found, JPEG_+_Comment will load the selected file into ADPro's image buffer.
  97.  
  98.  If JPEG_+_Comment is able to find comments, a large window will open showing
  99.  the following:
  100.  
  101.      File: <the JPEG file you selected>
  102.      Smoothing: <the Smoothing status of the JPEG Loader>
  103.  
  104.      Comment <number>: <Comment>
  105.  
  106.  After this window opens, JPEG_+_Comment will load the selected file into
  107.  ADPro's image buffer.  The window will remain open until you click on its
  108.  close gadget.
  109.  
  110.                          ------------------------
  111.  
  112.  Contacting the Author
  113.  =====================
  114.  If you have any bug reports, questions, suggestions, comments, or gifts to
  115.  send me or if you would like information about the most recent versions of
  116.  my programs, I would be glad to hear from you.  I would particularly like to
  117.  hear from you if:
  118.  
  119.  1. You come across a JPEG file that you know contains comments but
  120.    JPEG_+_Comment does not recognize it as a JPEG file or does not display
  121.    the comments.  If this occurs, I would appreciate it if you sent me a copy
  122.    of the file so that I could try to fix the problem.
  123.  
  124.  2. You have any information relating to:
  125.     a. JPEG file comments (programs that let you add/edit them, etc.)
  126.     b. the various JPEG file formats (the structure of JPEG files, what JPEG
  127.       file formats can contain comments, etc.)
  128.  
  129.  I can be reached at:
  130.  
  131.  E-mail:
  132.         Internet: (if you don't get a reply from one address, try the other)
  133.                   felixthecat@geocities.com
  134.                   75460.722@compuserve.com
  135.  
  136.       CompuServe: 75460,722
  137.  
  138.  WWW: www.geocities.com/Paris/2866
  139.  
  140.                          ------------------------
  141.  
  142.  Version History
  143.  ===============
  144.  1.10 May 21, 1995 - Minor improvements
  145.  ---------------------------------------------------------------------------
  146.  1.09 April 5, 1995 - JPEG_+Comment no longer differentiates between
  147.                       "Creation info" comments and other comments
  148.                     - Other minor improvements
  149.  ---------------------------------------------------------------------------
  150.  1.08 April 2, 1995 - Minor improvements
  151.  ---------------------------------------------------------------------------
  152.  1.07 March 26, 1995 - JPEG_+_Comment now searches the entire file for
  153.                        comments, instead of stopping at a certain point
  154.                      - Files are now read in variable size blocks (default
  155.                        64K)
  156.                      - Other minor improvements
  157.  ---------------------------------------------------------------------------
  158.  1.06 March 10, 1995 - JPEG_+_Comment should now be able to recognize all
  159.                        JFIF JPEG files
  160.  ---------------------------------------------------------------------------
  161.  1.05 March 6, 1995 - JPEG_+_Comment now detects multiple "Comment" comments
  162.                       if they are present and displays them as
  163.                       "Comment <number>:"
  164.                     - Other minor improvements
  165.  ---------------------------------------------------------------------------
  166.  1.04 March 1, 1995 - Fixed a bug that could prevent JPEG_+_Comment from
  167.                       detecting "Comment:" comments in certain rare cases
  168.                     - Fixed "Ctrl-d to abort" message to say "Ctrl-d to stop"
  169.  ---------------------------------------------------------------------------
  170.  1.03 February 28, 1995 - If the JPEG Loader runs into trouble while loading
  171.                           an image, JPEG_+_Comment will now make itself the
  172.                           currently selected loader before exiting
  173.  ---------------------------------------------------------------------------
  174.  1.02 February 23, 1995 - First public release
  175.  ---------------------------------------------------------------------------
  176.  1.0 January 15, 1995
  177.  ---------------------------------------------------------------------------
  178.  
  179.                          ------------------------
  180.  
  181.  Other Stuff by Felix Coronado
  182.  =============================
  183.  Look for these other fine ARexx scripts/programs by Felix Coronado:
  184.  
  185.  Cataloger - ARexx script for The Art Department Professional v2.x or
  186.              MorphPlus.  Makes image catalogs containing thumbnails of
  187.              selected files.
  188.              Features include:
  189.              - Loads & saves most ADPro/MorphPlus file formats
  190.              - Many options, different combinations can be saved & loaded
  191.              - Files can be picked from requesters, FRED Sequence files, or
  192.                ASCII file lists
  193.  
  194.  GIF_+_Comment - ARexx script that acts as a pseudo-Loader for The Art
  195.                  Department Professional v2.5.  Loads a GIF file while
  196.                  displaying any text comments contained in the file.
  197.  
  198.  ShowComment.rexx - ARexx program that searches for and displays any text
  199.                     comments contained in a JPEG or GIF file.
  200.